Skip to content

docs: clarify sandbox PAT permissions - #26236

Open
dave123981 wants to merge 1 commit into
docker:mainfrom
dave123981:docs-26225-sandbox-pat-permissions
Open

dave123981 wants to merge 1 commit into
docker:mainfrom
dave123981:docs-26225-sandbox-pat-permissions

Conversation

@dave123981

Copy link
Copy Markdown

Description

This PR clarifies the authentication requirements for accessing Docker Cloud Sandboxes through the API.

The documentation now explains the distinction between the sandbox:use permission on a personal access token (PAT) and the granular permissions required for individual Sandbox API operations.

Specifically, it clarifies that:

  • sandbox:use is required for the PAT to access Cloud Sandboxes.
  • sandbox:use does not automatically grant granular Sandbox API permissions.
  • Individual API operations require the corresponding account permissions.
  • Creating a sandbox requires sandboxesCreate.
  • Reading a sandbox requires sandboxesRead.
  • Deleting a sandbox requires sandboxesDelete.
  • Both the PAT requirement and the permission required by the API operation must be satisfied.

This makes the authentication and authorization requirements clearer for users working with the Sandboxes API.

Related issues or tickets

Fixes #26225

Reviews

  • Technical review
  • Editorial review
  • Product review

@dave123981
dave123981 requested a review from dvdksn as a code owner September 30, 2026 21:28
@netlify

netlify Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit d014b4c
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6abd7ee5ae82ab00086a4143
😎 Deploy Preview https://deploy-preview-26236--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs-scanner] Unclear relationship between sandbox:use PAT permission and granular account permissions

1 participant